home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / stprt203.zip / STORYPRT.DOC < prev    next >
Text File  |  1994-03-02  |  20KB  |  469 lines
  1.  
  2.  
  3.                                     STORYPRT
  4.  
  5.                              A text file printer by
  6.  
  7.                                Matthew E. Bernold
  8.  
  9.  
  10. INTRODUCTION:
  11. ─────────────
  12.  
  13.      This program started out as a little project to help out my wife, and
  14. it started as a very simple program.  Since that first version, STORYPRT
  15. has more than doubled in both size and functionality, and is a powerful
  16. enough utility that I feel that someone else besides my wife and I might
  17. actually find some use for it.  That is basically what this release is
  18. for anyway: to see if anyone else can use what I have written.
  19.  
  20.      My wife collects stories on the net, from X-rated stories to Star Trek
  21. parodies.  One summer when we had near-unrestricted access to a couple of
  22. printers, she decided to start printing these stories out.  She did this by
  23. using KEDIT and dumping the stories 60 lines per page.  This was ok, but
  24. she had to manually roll the paper ahead 3 lines to keep the pages centered.
  25. There was also a major incident when one of the stories was dropped after the
  26. pages had been ripped apart.  We had one HELL of a time putting them back in
  27. order.  Thus, the first STORYPRT was born.
  28.  
  29.      This first version was simple: Break up the story into 60 line packages,
  30. put a page number on the page on line 2, and that's it.  The version you have
  31. now does much more than that, and it is still growing.  If you find that you
  32. wish STORYPRT could do something that it doesn't, let me know.  You might find
  33. that feature in the next release.
  34.  
  35.  
  36. DISCLAIMER:
  37. ───────────
  38.  
  39.      This program is provided "as-is".  The author is not responsible for
  40. any damage or loss of data this program causes.  The only warranty provided
  41. is that I've used it for a long time, on a variety of systems, and it has
  42. never caused any damage on any of the systems that I use.
  43.  
  44.      You are hereby granted the right to use this program for "a reasonable
  45. trial period".  I have absolutely no idea exactly what this is, so I'll say
  46. somewhere around a month or so.  At the end of this "trial period" you must
  47. either register this software with the author, or die a horrible, suffering
  48. death (i.e. Destroy STORYPRT, and be forced to live your life without it.)
  49. Information on how to "register" is listed below.
  50.  
  51.      This program was written in Turbo Pascal 7.0, c. Borland.
  52.  
  53.  
  54. REGISTRATION:
  55. ─────────────
  56.  
  57.      This program is hereby declared "storyware".  If you find STORYPRT to
  58. be useful, please send me a $5 registration fee.  If you want automatic
  59. upgrades for new major releases of STORYPRT, please send $10 registration.
  60. This $10 registration fee includes shipping for ONE STORYPRT upgrade.  If
  61. you have an E-Mail address, I will E-Mail ALL new versions of STORYPRT as
  62. they become available. (Even non-major upgrades)
  63.  
  64. For $15 or more, I will program new options into STORYPRT for you if you
  65. want them.  For $6,892,329,047 I will write a program to infiltrate all
  66. known computer systems... :-)  Ok...so maybe I got a bit carried away...
  67.  
  68. If you can't afford to register STORYPRT, don't stop using it if you need
  69. it.  I've been there too (In fact, I'm there now) so you can temporarily
  70. 'register' by sending me one or more of the following:
  71.  
  72.    1) A picture postcard from your hometown telling me how much you
  73.       love STORYPRT. [Or maybe just that you use it.  :-)]
  74.    2) An FTP/FSP/Mail archive that houses X-rated stories.
  75.    3) An FTP/FSP/Mail archive that houses Star Trek parodies.
  76.    4) Your favorite X-rated story.
  77.    5) Your favorite Star Trek parody.
  78.  
  79. You can reach me at:
  80.  
  81.       Internet:  MEB117@PSUVM.PSU.EDU
  82.         Bitnet:  MEB117@PSUVM.BITNET
  83.     Snail Mail:  Matthew E. Bernold
  84.                  425 Waupelani Dr. Apt #221
  85.                  State College, PA  16801
  86.  
  87.  
  88. REQUIREMENTS:
  89. ─────────────
  90.  
  91.      STORYPRT requires the following:
  92.  
  93.       1) An IBM PC compatible with DOS 3.3 or better and 128K.  I only say
  94.          these values to be safe.  This program should work with any version
  95.          of DOS, and I have run it with 47K free memory.  STORYPRT stores one
  96.          printed page in memory at a time, so the maximum memory STORYPRT
  97.          needs is based on the number of lines per page, and the number of
  98.          characters per line.  The 47K figure is for the default 80 char/line
  99.          and 66 lines/page.
  100.       2) A printer capable of printing plain text files.  If your printer
  101.          is on port xxx: and you can type "dir > xxx:" and get a printout
  102.          of the directory, then STORYPRT will work with your printer.
  103.  
  104.  
  105. CONTENTS:
  106. ─────────
  107.  
  108.      This package should contain the following files:
  109.  
  110.          STORYPRT.EXE - Executable file.
  111.          STORYPRT.DOC - This document file.
  112.          DOCPRINT.BAT - Simple batch file to print the .DOC file.
  113.               U2D.EXE - Simple utility to convert Unix (LF) text
  114.                         files to MS-DOS (CR/LF) text files.
  115.  
  116.      If this package does not contain all of these files, it may NOT be
  117. distributed.  Please contact me at one of the addresses listed above to get a
  118. full version.
  119.  
  120.  
  121. DISTRIBUTION:
  122. ─────────────
  123.  
  124.      STORYPRT may be freely distributed as long as all files listed above
  125. are included in the package.  No fee beyond a reasonable duplication fee may
  126. be charged for STORYPRT.  STORYPRT may not be distributed with any commercial
  127. applications without the expressed written permission of the author.  Please
  128. contact me at the address listed above if you have any questions about
  129. distribution rights.
  130.  
  131.  
  132. INSTRUCTIONS:
  133. ─────────────
  134.  
  135.      STORYPRT does the following things to your file:
  136.  
  137.       1) Breaks the file up into pages (Default: 60 lines of text/page)
  138.       2) Puts a title and page number on line 2.
  139.       3) Makes sure that a page doesn't start with a blank line.  If
  140.          it does, it deletes the blank line.  This makes the printout
  141.          look much better.
  142.       4) Auto-wraps lines longer than 80 characters.  STORYPRT will try
  143.          to split lines on spaces when possible, but it does not wrap
  144.          paragraphs correctly.  This may be an option in future releases.
  145.       5) Allows you to set up your printer with setup/reset strings.
  146.          These strings are sent to the printer each time you print a file
  147.          with STORYPRT.  They can be used to change printer font, set
  148.          letter quality print, reset your printer, and much more.  See your
  149.          printer's manual for more information.
  150.  
  151.      STORYPRT is fairly easy to use.  If you just type the program name, you
  152. will get the following simple help screen:
  153.  
  154. ══════════
  155. STORYPRT v2.00b, c. Feb 1994, Matthew E. Bernold                   Help Screen
  156.  
  157. Syntax is STORYPRT [options] filename.ext [options] <title>
  158.  
  159. Type 'STORYPRT -h' for more information.
  160. ══════════
  161.  
  162.      Typing 'STORYPRT -h' or 'STORYPRT -?' will get you the following full
  163. help screen:
  164.  
  165. ══════════
  166. STORYPRT v2.00b, c. Feb 1994, Matthew E. Bernold                   Help Screen
  167.  
  168. Syntax is STORYPRT [options] filename.ext [options] <title>
  169.  
  170. Options:                               -#n : Start page numbering at n.
  171.  -Bn      : Start printing at Page n.  -En : End Printing at Page n.
  172.  -H or -? : Shows this screen.         -Cn : Sets n chars per line.  Def:80
  173.  -Sn,n..  : Printer setup string.      -Ln : Sets n lines per page.  Def:66
  174.  -Rn,n..  : Printer reset string.      -N  : Skip NetNews header.
  175.  -Pn      : Selects printer port.      -Xf : Output to file f.  No printing.
  176.  -M       : Manual paper feed.         -D  : Double Spaced output.
  177.  -T       : Title setup string.        -U  : Title reset string.
  178.  -I       : Lists information on the contents of STORYPRT.CFG.
  179.  -W or -O : Brings up configuration menu.  Does not print.
  180.  
  181. See STORYPRT.DOC for more information, and examples.  If you did not get this
  182. file, then your copy of STORYPRT is incomplete, and should not be distributed.
  183. You can obtain a complete version of STORYPRT from me by writing to
  184. MEB117@PSUVM.PSU.EDU or by US Mail:
  185.  
  186.       Matthew E. Bernold               Please include $5 shipping
  187.       425 Waupelani Driv